home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
bbsutil
/
gapdemo2.zip
/
QWKREP.ZIP
/
QWKREP.TXT
< prev
next >
Wrap
Text File
|
1993-04-19
|
10KB
|
286 lines
QWK/REP Sub-System
Description
The QWK/REP sub-system is a very basic method to allow your
callers to download QWK packets containing all new messages in
Forums the callers have selected. It also allows callers to
upload messages that were created with an off-line mail reader.
Setting Up
Setting up the QWK/REP sub-system is very similar to setting up a
door for use with GAP. The only basic difference is that this is
NOT a door and must not be configured as part of your doors
system since the commands to activate the modules are built in
commands and the initial prompts are a part of GAPBBS.
Create a directory off of your DEFAULT directory called QWKREP:
C:\GAP\QWKREP
This directory will contain the following files:
REPIMPRT.EXE
QWKEXPRT.EXE
QWKREPx.CNF
QWKH
QWKMENU
QWKMENUG
SEND.BAT
RECV.BAT
The QWKREPx.CNF is a configuration file that supplies the modules
with the necessary information they need in order to run. The 'x'
is the Node Number that the configuration applies to. If you run
single node GAP software, you may leave the node number off and
simply name the file QWKREP.CNF.
QWKH is a help file that is utilized by the QWK Module.
QWKMENU and QWKMENUG are Menus that are utilized by the QWK
Module.
SEND.BAT and RECV.BAT are batch files that the QWK modules will
invoke to send a QWK packet and receive a REP packet.
GAP Communications QWK/REP Sub-System
The configuration file consists of the following lines:
Default Directory
Name of BBS
IRQ
Base Address
QWK/REP ID
SEND.BAT
RECV.BAT
NODOSWIN (or blank)
SYSOP NAME
The Default Directory is the directory where your GAPBBS.CNF and
DOOR.SYS files reside.
The Name of BBS is your BBS Name.
The IRQ is the Interrupt Request Number for the port. This
applies only if you are using ports other than COM 1 and COM 2.
If you are using standard COM ports, enter a 0 on this line.
The Base Address is the Port address (in hexadecimal). This line
also only applies if you are using non-standard COM ports. If you
are using standard COM ports, enter a 0 on this line.
The QWK/REP ID is a unique Identifier for your BBS. It must be 8
characters or less in length and entered in all upper case.
The SEND.BAT file line can be given any DOS batch file name of
your choice. When a caller requests a QWK packet, the QWK module
will call this batch file to invoke DSZ or any other Zmodem
protocol program.
The following parameters will be passed to this batch file:
%1 - COM Port Number
%2 - COM Port Speed (DTE bps rate)
%3 - Caller's bps rate
%4 - The directory where the QWK packet is located.
Page 2
GAP Communications QWK/REP Sub-System
The RECV.BAT file line can be given any DOS batch file name of
your choice. When a caller requests a REP packet, the REP or QWK
module will call this batch file to invoke DSZ or any other
Zmodem protocol program.
The following parameters will be passed to this batch file:
%1 - COM Port Number
%2 - COM Port Speed (DTE bps rate)
%3 - Caller's bps rate
%4 - The directory where the Protocol should place the
REP packet.
Line 8 can either be NODOSWIN or the end of the configuration
file. When shelling to PKZIP or DSZ, the QWK/REP modules create a
"DOS Window" into which all output will be re-directed. If you
use a full screen version of DSZ or have other reasons for not
using the DOS Window, you may enter NODOSWIN on this line and the
modules will not attempt to redirect all DOS output to a window.
Line 9 is the Sysop's Real Name. When messages are imported, any
message that is TO the Sysop's real name will be changed to
SYSOP.
A sample configuration file would look like this:
QWKREP.CNF
---------------------------
C:\GAP
The Crow's Nest BBS
0
0
CROWNEST
SEND.BAT
RECV.BAT
USE DOS WINDOW
DARIN MAY
If you run multi nodes, you will need a separate configuation
file for each node.
Next you will need to create two batch files that GAP will invoke
when a caller types the appropriate QWK/REP command from the Main
Menu (the commands are also available from the Files Menu). These
batch files are placed in your DEFAULT directory.
Page 3
GAP Communications QWK/REP Sub-System
The first is called QWK.BAT. It is associated with the QWK
command. This file will invoke the QWKEXPRT.EXE module, passing
to it the name of the configuration file for the appropriate
node. Such a file would look like this:
QWK.BAT
---------------------------
@echo off
c:
cd \gap\qwkrep
qwkexprt qwkrep1.cnf
c:
cd \gap
Notice that the file changes into the QWKREP directory and
invokes the QWKEXPRT module, passing it the name of the
configuration file for Node 1. If you run muliple nodes, you will
need a QWK.BAT file for each node. The only difference between
the files would be the drive and directory designators, and the
line that calls up the QWKEXPRT module. Each node must use a
different configuration file and pass the name of this file to
the QWKEXPRT module.
The second batch file is called REP.BAT. It is associated with
the REP command. This file will invoke the REPIMPRT.EXE module,
passing to it the name of the configuration file for the
appropriate node. Such a file would look like this:
REP.BAT
---------------------------
@echo off
c:
cd \gap\qwkrep
repimprt qwkrep1.cnf
c:
cd \gap
Notice that the file changes into the QWKREP directory and
invokes the REPIMPRT module, passing it the name of the
configuration file for Node 1. If you run muliple nodes, you will
need a REP.BAT file for each node. The only difference between
the files would be the drive and directory designators, and the
line that calls up the REPIMPRT module. Each node must use a
different configuration file and pass the name of this file to
the REPIMPRT module.
Both QWK/REP modules can share the same configuation file.
Page 4